package com.sky.skyopsserver.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.sky.skyopsserver.domain.Environment;
import com.sky.skyopsserver.vos.*;

import java.util.List;

/**
 * 环境信息服务接口
 * 
 * @author Administrator
 * @description 针对表【environment(环境表)】的数据库操作Service
 * @createDate 2025-09-13 17:43:04
 */
public interface EnvironmentService extends IService<Environment> {

    /**
     * 添加环境
     * 
     * @param reqVO 添加环境请求VO
     * @return 环境ID
     */
    Long addEnvironment(EnvironmentAddReqVO reqVO);

    /**
     * 更新环境信息
     * 
     * @param reqVO 更新环境请求VO
     * @return 是否更新成功
     */
    Boolean updateEnvironment(EnvironmentUpdateReqVO reqVO);

    /**
     * 根据ID删除环境
     * 
     * @param id 环境ID
     * @return 是否删除成功
     */
    Boolean deleteEnvironment(Long id);

    /**
     * 批量删除环境
     * 
     * @param ids 环境ID列表
     * @return 是否删除成功
     */
    Boolean batchDeleteEnvironment(List<Long> ids);

    /**
     * 根据ID查询环境详情
     * 
     * @param id 环境ID
     * @return 环境详情
     */
    EnvironmentRspVO getEnvironmentById(Long id);

    /**
     * 分页查询环境列表
     * 
     * @param reqVO 分页查询请求VO
     * @return 分页结果
     */
    IPage<EnvironmentRspVO> getEnvironmentPage(EnvironmentPageReqVO reqVO);

    /**
     * 查询所有环境选项（用于下拉选择）
     * 
     * @return 环境选项列表
     */
    List<EnvironmentOptionRspVO> getAllEnvironmentOptions();

    /**
     * 查询有应用的环境选项
     * 
     * @return 环境选项列表
     */
    List<EnvironmentOptionRspVO> getEnvironmentOptionsWithApps();

    /**
     * 查询空环境选项
     * 
     * @return 环境选项列表
     */
    List<EnvironmentOptionRspVO> getEmptyEnvironmentOptions();

    /**
     * 获取环境统计信息
     * 
     * @return 环境统计信息
     */
    EnvironmentStatisticsRspVO getEnvironmentStatistics();

    /**
     * 检查环境编码是否已存在
     * 
     * @param code 环境编码
     * @param excludeId 排除的环境ID（用于更新时检查）
     * @return 是否存在
     */
    Boolean checkEnvironmentCodeExists(String code, Long excludeId);

    /**
     * 检查环境名称是否已存在
     * 
     * @param name 环境名称
     * @param excludeId 排除的环境ID（用于更新时检查）
     * @return 是否存在
     */
    Boolean checkEnvironmentNameExists(String name, Long excludeId);

    /**
     * 根据编码查询环境
     * 
     * @param code 环境编码
     * @return 环境信息
     */
    EnvironmentRspVO getEnvironmentByCode(String code);

    /**
     * 根据名称模糊查询环境
     * 
     * @param name 环境名称关键字
     * @return 环境列表
     */
    List<EnvironmentRspVO> searchEnvironmentByName(String name);

    /**
     * 根据编码模糊查询环境
     * 
     * @param code 环境编码关键字
     * @return 环境列表
     */
    List<EnvironmentRspVO> searchEnvironmentByCode(String code);

    /**
     * 获取环境下的应用数量
     * 
     * @param environmentId 环境ID
     * @return 应用数量
     */
    Long getApplicationCountByEnvironmentId(Long environmentId);

    /**
     * 批量获取环境下的应用数量
     * 
     * @param environmentIds 环境ID列表
     * @return 环境ID与应用数量的映射
     */
    java.util.Map<Long, Long> getApplicationCountByEnvironmentIds(List<Long> environmentIds);

    /**
     * 验证环境编码格式
     * 
     * @param code 环境编码
     * @return 是否有效
     */
    Boolean validateEnvironmentCode(String code);

    /**
     * 获取所有环境编码列表
     * 
     * @return 环境编码列表
     */
    List<String> getAllEnvironmentCodes();

    /**
     * 获取所有环境名称列表
     * 
     * @return 环境名称列表
     */
    List<String> getAllEnvironmentNames();
}
